Linux + Nginx + Uwsgi + Django 搭建单服务实现多域名访问
(给Python开发者加星标,提升Python技能)
作者:Python全家桶/李鹏辉 (本文来自作者投稿)
最近使用Django开发一个小程序和后台管理系统 ,需要将这两个不同的项目部署到同一个服务里面,然后使用不同的域名来访问不同的项目。Django默认的只支持单服务访问,要想实现不同域名,需要安装django的第三方扩展包:django-hosts。
本文通过一个简单的demo来给演示, 看本文的前提是需要对django有一定的认识,对项目环境的搭建以及Nginx有一定的了解。
平时习惯使用Anconda来管理Python包,所以本文也使用anconda管理环境,当然大家要是习惯使用virtuallen管理环境也没有问题。本文主要是演示怎么完整搭建一个单服务实现多域名访问的流程,不涉及具体的业务流程。
由于生成django项目需要先下载django包,所以我们先创建一个基本的虚拟环境,然后在虚拟环境中通过具体命令来生成项目文件。
1、环境搭建:applite_web
conda create --name applite_web
创建完虚拟环境applite_web了,现在需要下载一些依赖包。这里只需要单独安装django与django-hosts即可。
pip install django
pip install django-hosts
pip install uwsgi
2、创建项目:applite_web
django-admin.py startproject applite_web
3、创建app
# 这里创建4个app.
# app_1、app_2: 是用来匹配applite_web文件下,hosts.py文件分发的url
相当django原有的一级url.
# app_1_demo、app_2_demo: 是用来定义自己的API
创建app_1: django manage.py startapp app_1
创建app_2: django manage.py startapp app_2
创建app_1_demo: django manage.py startapp app_1_demo
创建app_2_demo: django manage.py startapp app_2_demo
说明2点:
1)、根据项目的需要,将原来Django项目结构做了调整
2)、至于创建4个app的用法后边会具体涉及到
下面截图是创建本文Demo项目结构,当然这也是比较简单的一个项目结构,实际项目开发中,还需要配置别的参数与文件。
2. 在applite_web中配置django-hosts
创建好虚拟环境和项目之后,接下来重点就是在django中配置多域名。为了方便起见,本文只演示2个域名,多个域名按照2个域名的方式增加就行。
1、首先在settins.py同级增加一个hosts.py文件,配置如下:
from django_hosts import patterns, host
host_patterns = patterns(
host(r'app1', 'app_1.urls', name='app1'),
host(r'app2', 'app_2.urls', name='app2'),
)
2、然后在django的settings配置文件增加3处配置:
在INSTALLED_APPS中增加下面几个
INSTALLED_APPS = [
"django_hosts",
'app_1',
'app_2',
"app_1_demo",
"app_2_demo",
]
需要在 MIDDLEWARE 的首行和末行增加2行配置
MIDDLEWARE = [
'django_hosts.middleware.HostsRequestMiddleware',
......
'django_hosts.middleware.HostsRequestMiddleware',
]
在ROOT_URLCONF下行增加如下2行参数配置
# 客户端的请求通过这个配置被转发到hoss.py文件的host_patterns中匹配
ROOT_HOSTCONF = 'applite_web.hosts'
# 设置一个默认域名,在没有匹配所有请求的域名时,默认请求这个域名
DEFAULT_HOST = 'app1'
app_1的urls.py文件如下:
from django.urls import path, include
urlpatterns = [
path("app1/", include("app_1_demo.urls"))
]
app_2的urls.py文件如下
from django.urls import path, include
urlpatterns = [
path("app2/", include("app_2_demo.urls")),
]
2、然后在app_1_demo、app_2_demo中分别增加对应的url和views函数
在app_1中匹配成功之后,会直接跳转到app_1_demo的urls,再根据当前的匹配跳转当前的views函数
1)、首先匹配app_1_demo的urls的路由:
from django.urls import path
from .views import app_1_view
urlpatterns = [
path("", app_1_view),
]
2)、urls匹配成功之后,跳转这里的视图函数,并返回响应
from django.http.response import HttpResponse
# Create your views here.
def app_1_view(request):
return HttpResponse("hello i'm app_1")
同理,app_2匹配成功之后,会直接跳转到app_2_demo的urls,再根据当前的匹配跳转当前的views函数
1)、首先匹配app_2_demo的urls的路由,匹配如下:
from django.urls import path, include
from .views import app_2_view
urlpatterns = [
path("", app_2_view)
]
2)、urls匹配成功之后,跳转这里的视图函数,并返回响应
from django.http.response import HttpResponse
# Create your views here.
def app_2_view(request):
return HttpResponse("hello i'm app_2")
4.域名绑定与测试
经过上边三步的操作,已经完成了一个基本的演示功能。本文目的是通过Nginx负载单服务后,在一个服务里面来实现不同域名的访问,所以在配置uwgi和Nginx参数,还需要绑定域名。
1、这里是在同一个局域网下通过两台机器实现用户的访问:
访问机器IP: 192.168.2.17, 部署服务的IP: 192.168.2.200。在实际生产需要购买真实的域名,这里作为演示,可以通过在本机绑定服务器的ip的方式来实现对另一台机器服务的访问,具体修改如下:
# 需要进入到此文件中编辑增加下面两行:sudo vim /etc/hosts
# 这里我们分别给192.168.2.200绑定app1.cc与app2.cc两个域名
192.168.2.200 app1.cc
192.168.2.200 app2.cc
2、绑定完之后,然后将本项目放到192.168.2.200机器上,测试当前的服务配置没有问题。
项目放置路径为: /home/yxy/payneli/applite_web/
进入app文件夹下,然后运行项目,命令如下:
python manage.py runserver 192.168.2.200:8000
浏览器输入:app1.cc:8000/app1/,如果浏览器显示如下结果,说明项目配置与域名绑定成功
5.uwsgi参数配置与测试
前边几步成功之后,接下来就是配置uwsgi的参数。熟悉Python后台开发的都应该清楚,开发的时候使用的 python manage.py runserver 来运行服务器,这只适用开发时的代码调试,而实际项目部署的话,django内置的服务根本无法满足需求。而Uwsgi作为Python服务器不仅可以提供稳定的服务,同时还可以提供大的并发量,所以在后台开发中,用的比较多。
1、在项目文件夹下,创建一个uwsgi文件夹。进入该文件夹,创建uwsgi.ini文件,里面的配置参数如下:
[uwsgi]
# 项目目录
chdir=/home/yxy/payneli/applite_web/app/
# 指定项目的application
wsgi-file=applite_web/wsgi.py
# 指定sock的文件路径
socket=/home/yxy/payneli/applite_web/uwsgi/uwsgi.sock
# 进程个数
workers=1
pidfile=/home/yxy/payneli/applite_web/uwsgi/uwsgi.pid
# 指定IP端口
# nginx负载均衡使用socket,uwsgi启动服务使用http
#socket=192.168.2.200:8000
http=192.168.2.200:8000
# 启用主进程
master=true
# 自动移除unix Socket和pid文件当服务停止的时候
vacuum=true
# 序列化接受的内容,如果可能的话
thunder-lock=true
# 启用线程
enable-threads=true
# 设置自中断时间
harakiri=30
# 设置缓冲
post-buffering=4096
# 设置日志目录
daemonize=/home/yxy/payneli/applite_web/logs/uwsgi.log
2、配置完成后,运行下面的命令,启动服务。
# 在项目路径下,启动服务命令如下:
uwsgi --ini ./uwsgi/uwsgi.ini
启动完成后,uwsgi文件夹里面就会多出两个文件:uwsgi.pid uwsgi.sock
然后查看当前服务是否启动成功:
# 命令如下
ps -ef|grep uwsgi
当显示如下图所示的时候,说明uwsgi已经将项目启动成功
3、浏览器测试服务是否正常:
在浏览为直接输入:app1.cc:8000/app1/,如果显示如下,说明uwsgi配置成功
6. Nginx配置与测试
如果前边5步没有问题的话,那么恭喜你,就差最后一步就可以完成本demo的演示了。现在就开始最后一步,配置Nginx参数。
1、首先安装Nginx,本文对nginx安装不做讲解,毕竟网上教程那么多,可以找一个好的教程照着操作就可以。小编将Nginx安装为默认路径,在:/usr/local/nginx,进入此文件下,直接命令行启动。
/usr/local/nginx/sbin/nginx
查看Nginx是否启动成功,命令如下:
ps -ef|grep nginx
显示如下图,说明Nginx启动成功
浏览器输入:app1.cc,显示如下所示,说明Nginx安装成功
2、检查Nginx配置没有问题之后,就是配置多域名了。
注释掉Nginx原有的配置server
增加如下一行参数,主要是为了方便单独增加配置app1.cc、与app2.cc两个域名的文件
分别在 /usr/nginx/conf/文件加下,创建一个新的multihosts文件夹,进入该文件夹分别新建 app1.cc.conf、app2.cc.conf文件,具体的配置参数如下:
app1.cc.conf配置如下:
server{
listen 80; # 默认监听80端口
server_name app1.cc; # 访问的域名
#index index.html inex.htm index.php;
#root /data/www/applite_web/;
access_log /usr/local/nginx/logs/app1.log logmain;
rewrite_log on;
#error_page 404 /404.html;
location / { # 通用匹配,任何未匹配到其它location的请求都会匹配到
include uwsgi_params; # uwsgi参数
uwsgi_pass 192.168.2.200:8000; # 负载后台服务
uwsgi_param UWSGI_CHDIR /home/yxy/payneli/applite_web/app/;
uwsgi_param UWSGI_SCRIPT applite_web.wsgi;
client_max_body_size 35m;
uwsgi_send_timeout 1060;
uwsgi_connect_timeout 1060;
uwsgi_read_timeout 1060;
}
app2.cc.conf配置如下:
server{
listen 80;
server_name app2.cc;
#index index.html inex.htm index.php;
#root /home/yxy/www/applite_web/;
access_log /usr/local/nginx/logs/app2.log logmain;
rewrite_log on;
#error_page 404 /404.html;
location / {
include uwsgi_params;
uwsgi_pass 192.168.2.200:8000;
uwsgi_param UWSGI_CHDIR /home/yxy/payneli/applite_web/app/;
uwsgi_param UWSGI_SCRIPT applite_web.wsgi;
client_max_body_size 35m;
uwsgi_send_timeout 1060;
uwsgi_connect_timeout 1060;
uwsgi_read_timeout 1060;
}
}
3、多域名的参数配置完成,但是此刻不要忘了,当使用Nginx作为负载均衡时候,需要将uwsgi.ini里面的参数http改为socket具体如下:
# nginx负载均衡使用socket,uwsgi启动服务使用http
socket=192.168.2.200:8000
# http=192.168.2.200:8000
4、到这里本文的参数已经配置完成,然后我们需要重新自动Nginx,查看显示如上边启动效果,说明启动成功,接下来就是浏览器检测多域名配置是否正确:
分别输入:app1.cc、app2.cc显示结果如下,说明多域名已经配置成功
到此为止,单服务实现多域名访问已经演示完成。当然,本文只是做了一个简单的demo版本,而实际项目开发的过程中,还需要根据实际需要评估,决定到底是nginx后台负载多服务,还是nginx负载单服务映射多域名。
发送 1225,可获取本文源码。
【本文作者】
李鹏辉:就职于深圳一家科技公司AI部门,目前负责Python后台开发和数据挖掘相关工作。工作之余也在运营公号「Python全家桶」。
推荐阅读
(点击标题可跳转阅读)
觉得本文对你有帮助?请分享给更多人
关注「Python开发者」加星标,提升Python技能
喜欢就点一下「好看」呗~